DrawChar

Draw a character at current pen location

#include <Quickdraw.h> Quickdraw

void DrawChar(theChar );

char theChar ; ASCII value of character to draw

The specified character is drawn in the current GrafPort, using the current

font, size, style, and transfer mode. The character is drawn with the left end

of its baseline starting at the current pen location. The pen advances

appropriately.

theChar is any ASCII character. If the character does not exist in the current

font, the "missing" symbol is drawn.

Notes: The appearance of the character is affected by the current font, size, style,

and transfer mode (see TextFont, TextSize, TextFace, and TextMode).

The character may extend as high as the ascent line and as low as the

descent line. Use GetFontInfo to find the values of these measurements.

The character width is variable for proportional fonts; use CharWidth to

obtain the width, in pixels, of an individual character in the current font.

For drawing multiple characters, it is far faster to use DrawString or

DrawText than it is to make multiple calls to DrawChar.

If you use scaled or fractional-width fonts while drawing a string,

repeatedly calling DrawChar may draw a string with a length different

from the length that StringWidth computes and different from the length

of the string that DrawString draws. However, repeatedly calling

CharWidth always computes the length of the string that repeatedly

calling DrawChar draws. The differences are due to rounding errors,

since QuickDraw uses fixed-point math. For example, if the current size

is 11 but the System file doesn't contain an 11-point version that font, the

System will scale the 12-point version down and will probably en counter

rounding errors.

Before drawing a character, make sure the current GrafPort is big enough

to contain it. If the GrafPort is not as wide as the character, your program

will crash with an address error.